Purpose

Reading and Saving Data

Class Hierarchy

Interface List

Source Code

Registration

DISCLAIMER OF WARRANTY

               THIS SOFTWARE AND DOCUMENTATION ARE SOLD "AS IS" AND WITHOUT

               WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY

               OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE

               OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO

               WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR

               A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING

               PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED

               WITH NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER

               MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY

               LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO

               PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.


Purpose

The RoHon C++ Class Browser (RCCB) allows you to view class definitions contained in one or more C++ headers (*.H, *.HPP) and/or implementation (*.CPP) source files as:

-	class hierarchy, an indented list of class tree(s)

-	object interfaces listing methods and data items for a class

-	source code for a particular interface or class definition

You may import a number of source files into one class hierarchy view or create several views.

You may also identify a Windows *.HLP (help) describing the imported classes. The Alt-F1 key will then attempt to display the help text for a class or interface.


Reading and Saving Data

Use the File-Import(Alt-F-I) menu option to read one or more  C++ header (*.HPP,*H) or implementation (*.CPP) files. The definitions will be added to the current class hierarchy window.

Once you have scanned a logical group of C++ files you may save the names of source files you have imported in an *.RCB file and use it to open the hierarchy view again without needing to identify each source file separately.

Note:	You may use the Windows drag-and-drop mechanism to open one or more RCB and/or C++ source files by dragging their icons from the File Manager onto the main RCCB window (RCB files only) or an open class hierarchy window (C++ source files).

Note:	The compiler used to scan C++ source is not very sophisticated and may not be able to read all the all possible C++ constructs . In testing it managed to read all the Borland ® OWL and Microsoft ®  MFC classes with some exceptions. For example, it does not recognize () or [] when used to define operators (as in: int operator [](int i);). It does not use macro expansion, so if you hide C++ reserved words in a macro define (e.g. #define KLAS class) RCCB will fail to understand your source. Also, it uses only the name of a method as its identifier, so it will not distinguish methods with varying signatures (parameter lists). We are planning to remove some of these restrictions in future releases.


 Class Hierarchy

Class Hierarchy window displays one or more classes and their descendants. It may contain more than one hierarchy tree if all the classes do not share a common parent. You may collapse a sub-tree by double left-clicking (mouse button) on its root. You should open (File New) additional Class Hierarchy views when reading source with totally unrelated classes, e.g. it would make not much sense to combine OWL and MFC definitions into one view.

You can open two additional types of views of a selected class using the View menu or buttons on the toolbar:

-	source code to display the C++ header files defining the class

-	list of interfaces for the currently selected class.

You can also associate (File-Class help menu option) a help file with further description of the classes you have imported (eg. BCW.HLP for Borlands ® class library classes). Help-Keyword menu option  will then display the appropriate help topic.


Interface List

Interface List window shows interfaces (variables and methods) of objects of the class currently selected in the class hierarchy window. You can limit the display by controlling whether to:

-	include interfaces provided by the parent classes

-	include internally visible intefaces (all interfaces of the current class and protected interfaces of the parent classes)

You can open a view of the source code (usually *.CPP) file which implements the interface (obviously, only if the source code had been imported into the tool).

Individual interfaces are preceded by an icon identifying their type:

  identifies non-virtual functions

  identifies a virtual function

  identifies a variable

Interface List is a modeless dialog - its contents will be updated automatically as you change your class selection in the  class hierarchy view.


Source Code

This window displays the C++ source code from which a class or interface definition was originally obtained. The display is scrolled to display the line where the definition starts at the top of the window.

Maximum source file size currently handled by the tool is app 64K.


Registration

This is a shareware product. You may use it free of charge for a period of 30 days. If you wish to continue after this trial period please register by:

-	posting your name , postal (physical or e-mail) details and a cheque for US $35-00 (or your local black market equivalent) to the address below, or

-	using CompuServe ®  GO SWREG facility, registration number 5806.

This will allow me to continue developing the product and I will for a period of 90 days from the date of your registration.:

-	grant you the right to use any new versions released during that time

-	respond to technical queries you may have regarding the product

-	attempt to ensure the browser is capable of analyzing any idiosynchratic C++ code you may have!

Whether or not you decide to register, we would be be keen to hear any comments you may have about the tool.

Our address is:

RoHon Systems

8220 S Tamarac Str.

Englewood CO 80112

USA

CompuServe: 	102073, 3612

Internet: 	102073.3612@compuserve.com